<!DOCTYPE html>
<html lang="en-US">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <title>第 6 小节：提交第一个 Issue | 开源指北</title>
    <meta name="generator" content="VuePress 1.8.0">
    <script src="https://cdn.jsdelivr.net/npm/react/umd/react.production.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/react-dom/umd/react-dom.production.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/vue/dist/vue.min.js"></script>
    <script src="https://cdn.jsdelivr.net/npm/@babel/standalone/babel.min.js"></script>
    <link rel="icon" href="/presstest/favicon.ico">
    <link rel="icon" href="/presstest/assets/icon/chrome-mask-512.png" type="image/png" sizes="512x512">
    <link rel="icon" href="/presstest/assets/icon/chrome-mask-192.png" type="image/png" sizes="192x192">
    <link rel="icon" href="/presstest/assets/icon/chrome-512.png" type="image/png" sizes="512x512">
    <link rel="icon" href="/presstest/assets/icon/chrome-192.png" type="image/png" sizes="192x192">
    <link rel="manifest" href="/presstest/manifest.webmanifest" crossorigin="use-credentials">
    <link rel="apple-touch-icon" href="/presstest/assets/icon/apple-icon-152.png">
    <meta name="description" content="一份给开源新手的保姆级开源百科">
    <meta property="og:url" content="https://vuepress-theme-demo.mrhope.site/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%206%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E6%8F%90%E4%BA%A4%E7%AC%AC%E4%B8%80%E4%B8%AA%20Issue.html">
    <meta property="og:site_name" content="开源指北">
    <meta property="og:title" content="第 6 小节：提交第一个 Issue">
    <meta property="og:type" content="article">
    <meta property="og:locale" content="en-US">
    <meta name="twitter:card" content="summary_large_image">
    <meta name="twitter:image:alt" content="开源指北">
    <meta property="article:author" content="开源指北编写小组">
    <meta name="theme-color" content="#46bd87">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">
    <meta name="msapplication-TileImage" content="/assets/icon/ms-icon-144.png">
    <meta name="msapplication-TileColor" content="#ffffff">
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no, viewport-fit=cover">
    
    <link rel="preload" href="/presstest/assets/css/0.styles.bab820ff.css" as="style"><link rel="preload" href="/presstest/assets/js/app.2f1bfa80.js" as="script"><link rel="preload" href="/presstest/assets/js/layout-Layout.87e745e0.js" as="script"><link rel="preload" href="/presstest/assets/js/vendors~layout-Blog~layout-Layout~layout-NotFound.5885b1db.js" as="script"><link rel="preload" href="/presstest/assets/js/vendors~layout-Blog~layout-Layout~layout-NotFound~layout-Slide.19644d68.js" as="script"><link rel="preload" href="/presstest/assets/js/vendors~layout-Blog~layout-Layout.5e573c4d.js" as="script"><link rel="preload" href="/presstest/assets/js/page-第6小节：提交第一个Issue.25921032.js" as="script"><link rel="prefetch" href="/presstest/assets/js/54.103e364b.js"><link rel="prefetch" href="/presstest/assets/js/55.0e057ec2.js"><link rel="prefetch" href="/presstest/assets/js/56.4340d876.js"><link rel="prefetch" href="/presstest/assets/js/57.d98861e6.js"><link rel="prefetch" href="/presstest/assets/js/58.904015a7.js"><link rel="prefetch" href="/presstest/assets/js/layout-Blog.b44342cf.js"><link rel="prefetch" href="/presstest/assets/js/layout-NotFound.a47013aa.js"><link rel="prefetch" href="/presstest/assets/js/layout-Slide.6c07e077.js"><link rel="prefetch" href="/presstest/assets/js/page-开源指北.b028ea3e.js"><link rel="prefetch" href="/presstest/assets/js/page-第1小节：个人维护和建立社区，两者如何选择.be94170a.js"><link rel="prefetch" href="/presstest/assets/js/page-第1小节：什么是开源.7757fa39.js"><link rel="prefetch" href="/presstest/assets/js/page-第1小节：如何找到适合自己学习和使用的开源项目.a1bd7da8.js"><link rel="prefetch" href="/presstest/assets/js/page-第1小节：开源项目中的不同角色.7f341f65.js"><link rel="prefetch" href="/presstest/assets/js/page-第1小节：怎样在本职工作和开源项目间做好平衡.cf4b1a56.js"><link rel="prefetch" href="/presstest/assets/js/page-第1小节：有了开源的想法后从何开始.565acce8.js"><link rel="prefetch" href="/presstest/assets/js/page-第2小节：个人为什么要参与开源贡献.1baa602b.js"><link rel="prefetch" href="/presstest/assets/js/page-第2小节：为开源项目建立良好的基础.4dde99c0.js"><link rel="prefetch" href="/presstest/assets/js/page-第2小节：关于开源项目的商业化.19073793.js"><link rel="prefetch" href="/presstest/assets/js/page-第2小节：开源与个人技术成长.296505c5.js"><link rel="prefetch" href="/presstest/assets/js/page-第2小节：开源项目的源代码该怎么读.cd7b6074.js"><link rel="prefetch" href="/presstest/assets/js/page-第2小节：打造开源社区.83a50dd2.js"><link rel="prefetch" href="/presstest/assets/js/page-第3小节：企业为什么要参与开源.58e94b70.js"><link rel="prefetch" href="/presstest/assets/js/page-第3小节：如何判断一个项目是否是开源的.b78fba85.js"><link rel="prefetch" href="/presstest/assets/js/page-第3小节：开源许可证的应用.57265395.js"><link rel="prefetch" href="/presstest/assets/js/page-第3小节：开源项目的常见治理架构.49103421.js"><link rel="prefetch" href="/presstest/assets/js/page-第3小节：认识开源许可证.7e3abb0b.js"><link rel="prefetch" href="/presstest/assets/js/page-第4小节：为自己的开源项目建立贡献准则.0d4cddbc.js"><link rel="prefetch" href="/presstest/assets/js/page-第4小节：关于开源基金会.4990275e.js"><link rel="prefetch" href="/presstest/assets/js/page-第4小节：可以用哪些方式参与开源.b32e9ffa.js"><link rel="prefetch" href="/presstest/assets/js/page-第4小节：开源中的赞赏文化.6a0b71be.js"><link rel="prefetch" href="/presstest/assets/js/page-第4小节：确保开源代码质量的几个要点.952e9b26.js"><link rel="prefetch" href="/presstest/assets/js/page-第5小节：如何找到最强开源项目.a2715494.js"><link rel="prefetch" href="/presstest/assets/js/page-第5小节：如何找到适合的项目进行贡献.4d139b27.js"><link rel="prefetch" href="/presstest/assets/js/page-第5小节：开源项目的维护和管理.cfbce288.js"><link rel="prefetch" href="/presstest/assets/js/page-第5小节：有关开源的常见误区.9b6fc03d.js"><link rel="prefetch" href="/presstest/assets/js/page-第6小节：CONTRIBUTING编写.b024cf43.js"><link rel="prefetch" href="/presstest/assets/js/page-第6小节：常见文件认识.8c024542.js"><link rel="prefetch" href="/presstest/assets/js/page-第7小节：企业视角看待开源.1144c4ca.js"><link rel="prefetch" href="/presstest/assets/js/page-第7小节：提交第一个PullRequest.5f49ddbc.js"><link rel="prefetch" href="/presstest/assets/js/page-第8小节：如何成为一个项目的核心贡献者.1f39bf0d.js"><link rel="prefetch" href="/presstest/assets/js/page-第8小节：开源发展趋势.a79afcbb.js"><link rel="prefetch" href="/presstest/assets/js/page-第9小节：开源项目的贡献准则和贡献者公约.ea564d6c.js"><link rel="prefetch" href="/presstest/assets/js/page-第一部分：初识开源.5e449a6a.js"><link rel="prefetch" href="/presstest/assets/js/page-第三部分：尝试参与开源.ff6804a5.js"><link rel="prefetch" href="/presstest/assets/js/page-第二部分：学习和使用开源项目.89615154.js"><link rel="prefetch" href="/presstest/assets/js/page-第五部分：开源治理.fcf2766b.js"><link rel="prefetch" href="/presstest/assets/js/page-第六部分：有关开源的其他问题.964a2af5.js"><link rel="prefetch" href="/presstest/assets/js/page-第四部分：启动自己的开源项目.f46503a5.js"><link rel="prefetch" href="/presstest/assets/js/vendors~flowchart.af876bfc.js"><link rel="prefetch" href="/presstest/assets/js/vendors~photo-swipe.edee0a99.js"><link rel="prefetch" href="/presstest/assets/js/vendors~reveal.24dd46f7.js"><link rel="prefetch" href="/presstest/assets/js/vendors~valine.f7b972d5.js">
    <link rel="stylesheet" href="/presstest/assets/css/0.styles.bab820ff.css">
  </head>
  <body>
    <div id="app" data-server-rendered="true"><div class="theme-container has-navbar has-sidebar has-anchor"><header class="navbar"><button class="sidebar-button"><span class="icon"></span></button> <a href="/presstest/" class="home-link router-link-active"><img src="/presstest/logo.svg" alt="开源指北" class="logo"> <!----> <span class="site-name can-hide">开源指北</span></a> <div class="links"><button class="color-button"><svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" class="skin-icon"><path d="M224 800c0 9.6 3.2 44.8 6.4 54.4 6.4 48-48 76.8-48 76.8s80 41.6 147.2 0 134.4-134.4
        38.4-195.2c-22.4-12.8-41.6-19.2-57.6-19.2C259.2 716.8 227.2 761.6 224 800zM560 675.2l-32
        51.2c-51.2 51.2-83.2 32-83.2 32 25.6 67.2 0 112-12.8 128 25.6 6.4 51.2 9.6 80 9.6 54.4 0
        102.4-9.6 150.4-32l0 0c3.2 0 3.2-3.2 3.2-3.2 22.4-16 12.8-35.2
        6.4-44.8-9.6-12.8-12.8-25.6-12.8-41.6 0-54.4 60.8-99.2 137.6-99.2 6.4 0 12.8 0 22.4
        0 12.8 0 38.4 9.6 48-25.6 0-3.2 0-3.2 3.2-6.4 0-3.2 3.2-6.4 3.2-6.4 6.4-16 6.4-16 6.4-19.2
        9.6-35.2 16-73.6 16-115.2 0-105.6-41.6-198.4-108.8-268.8C704 396.8 560 675.2 560 675.2zM224
        419.2c0-28.8 22.4-51.2 51.2-51.2 28.8 0 51.2 22.4 51.2 51.2 0 28.8-22.4 51.2-51.2 51.2C246.4
        470.4 224 448 224 419.2zM320 284.8c0-22.4 19.2-41.6 41.6-41.6 22.4 0 41.6 19.2 41.6 41.6 0
        22.4-19.2 41.6-41.6 41.6C339.2 326.4 320 307.2 320 284.8zM457.6 208c0-12.8 12.8-25.6 25.6-25.6
        12.8 0 25.6 12.8 25.6 25.6 0 12.8-12.8 25.6-25.6 25.6C470.4 233.6 457.6 220.8 457.6 208zM128
        505.6C128 592 153.6 672 201.6 736c28.8-60.8 112-60.8 124.8-60.8-16-51.2 16-99.2
        16-99.2l316.8-422.4c-48-19.2-99.2-32-150.4-32C297.6 118.4 128 291.2 128 505.6zM764.8
        86.4c-22.4 19.2-390.4 518.4-390.4 518.4-22.4 28.8-12.8 76.8 22.4 99.2l9.6 6.4c35.2 22.4
        80 12.8 99.2-25.6 0 0 6.4-12.8 9.6-19.2 54.4-105.6 275.2-524.8 288-553.6
        6.4-19.2-3.2-32-19.2-32C777.6 76.8 771.2 80 764.8 86.4z"></path></svg> <div class="color-picker-menu" style="display:none;"><div class="theme-options"><ul class="themecolor-select"><label for="themecolor-select">Theme Color:</label> <li><a href="#" class="default-theme"></a></li> </ul> <div class="darkmode-toggle"><label for="darkmode-toggle" class="desc">Theme Mode:</label> <div class="darkmode-switch"><div class="item day"><svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" class="icon light-icon"><path d="M512 256a42.667 42.667 0 0042.667-42.667V128a42.667 42.667 0 00-85.334 0v85.333A42.667 42.667 0 00512 256zm384 213.333h-85.333a42.667 42.667 0 000 85.334H896a42.667 42.667 0 000-85.334zM256 512a42.667 42.667 0 00-42.667-42.667H128a42.667 42.667 0 000 85.334h85.333A42.667 42.667 0 00256 512zm9.387-298.667a42.667 42.667 0 00-59.307 62.72l61.44 59.307a42.667 42.667 0 0031.147 11.947 42.667 42.667 0 0030.72-13.227 42.667 42.667 0 000-60.16zm459.946 133.974a42.667 42.667 0 0029.44-11.947l61.44-59.307a42.667 42.667 0 00-57.6-62.72l-61.44 60.587a42.667 42.667 0 000 60.16 42.667 42.667 0 0028.16 13.227zM512 768a42.667 42.667 0 00-42.667 42.667V896a42.667 42.667 0 0085.334 0v-85.333A42.667 42.667 0 00512 768zm244.48-79.36a42.667 42.667 0 00-59.307 61.44l61.44 60.587a42.667 42.667 0 0029.44 11.946 42.667 42.667 0 0030.72-12.8 42.667 42.667 0 000-60.586zm-488.96 0l-61.44 59.307a42.667 42.667 0 000 60.586 42.667 42.667 0 0030.72 12.8 42.667 42.667 0 0028.587-10.666l61.44-59.307a42.667 42.667 0 00-59.307-61.44zM512 341.333A170.667 170.667 0 10682.667 512 170.667 170.667 0 00512 341.333z" fill="currentColor"></path></svg></div> <div class="item auto active"><svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" class="icon auto-icon"><path d="M460.864 539.072H564.8L510.592 376l-49.728 163.072zM872 362.368V149.504H659.648L510.528 0l-149.12 149.504H149.12v212.928L0 511.872l149.12 149.504v212.928h212.352l149.12 149.504 149.12-149.504h212.352V661.376l149.12-149.504L872 362.368zM614.464 693.12l-31.616-90.624H438.272l-31.616 90.624h-85.888l144.576-407.68h90.368l144.576 407.68h-85.824zm0 0" fill="currentColor"></path></svg></div> <div class="item night"><svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" class="icon dark-icon"><path d="M935.539 630.402c-11.43-11.432-28.674-14.739-43.531-8.354-46.734 20.103-96.363 30.297-147.508 30.297-99.59 0-193.221-38.784-263.64-109.203-108.637-108.637-139.61-270.022-78.908-411.148a39.497 39.497 0 00-51.886-51.887c-52.637 22.64-100.017 54.81-140.826 95.616-85.346 85.346-132.346 198.821-132.346 319.52 0 120.7 47.001 234.172 132.347 319.519S408.063 947.11 528.76 947.11c120.7 0 234.172-47.003 319.52-132.351 40.809-40.81 72.978-88.19 95.616-140.826a39.497 39.497 0 00-8.356-43.532z" fill="currentColor"></path></svg></div></div> <!----></div></div></div></button> <div class="search-box"><input aria-label="Search" autocomplete="off" spellcheck="false" value=""> <!----></div> <nav class="nav-links can-hide"><div class="nav-item"><a href="/presstest/" class="nav-link router-link-active"><i class="iconfont icon-home"></i>
  首页
</a></div> <a rel="noopener noreferrer" href="https://gitee.com/gitee-community/opensource-guide" target="_blank" class="repo-link">
    Gitee
    <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav></div></header> <div class="sidebar-mask"></div> <aside class="sidebar"><div class="blogger-info mobile"><div class="blogger-wrapper"><div aria-label="Personal Intro" data-balloon-pos="down" class="blogger hasIntro"><img alt="blogger-avatar" src="/presstest/logo.svg" class="avatar"> <div class="name">开源指北编写小组</div></div></div> <div class="num-wrapper"><div><div class="num">40</div> <div>Articles</div></div> <div><div class="num">0</div> <div>Category</div></div> <div><div class="num">0</div> <div>Tags</div></div> <div><div class="num">0</div> <div>Timeline</div></div></div> <div class="media-links-wrapper bottom-media-link"><a href="https://gitee.com/gitee-community/opensource-guide" rel="noopener noreferrer" target="_blank" aria-label="Gitee" data-balloon-pos="up" class="media-link"><span class="sr-only">Gitee</span> <svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" class="icon icon-gitee"><circle cx="512" cy="512" r="512" fill="#C71D23"></circle> <path d="M772.953 454.723H480.17v.006a25.46 25.46 0 00-25.46 25.453l-.025 63.649a25.46 25.46 0 0025.46 25.466l178.242-.007a25.46 25.46 0 0125.459 25.46v12.73c0 42.18-34.198 76.378-76.378 76.378H365.583a25.46 25.46 0 01-25.46-25.46V416.533h-.006c0-42.18 34.192-76.378 76.378-76.378h356.388v-.013a25.46 25.46 0 0025.46-25.446l.057-63.65h.013a25.46 25.46 0 00-25.46-25.471l-356.432.012c-105.453 0-190.946 85.493-190.946 190.946v356.433a25.46 25.46 0 0025.46 25.46H626.56c94.913 0 171.852-76.94 171.852-171.852V480.182a25.46 25.46 0 00-25.46-25.46z" fill="#fff"></path></svg></a></div></div> <hr>  <nav class="nav-links"><div class="nav-item"><a href="/presstest/" class="nav-link router-link-active"><i class="iconfont icon-home"></i>
  首页
</a></div> <a rel="noopener noreferrer" href="https://gitee.com/gitee-community/opensource-guide" target="_blank" class="repo-link">
    Gitee
    <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></nav>  <ul class="sidebar-links"><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><!----> <span>第一部分：初识开源</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/presstest/%E7%AC%AC%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%9A%E5%88%9D%E8%AF%86%E5%BC%80%E6%BA%90/%E7%AC%AC%201%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E4%BB%80%E4%B9%88%E6%98%AF%E5%BC%80%E6%BA%90/" class="sidebar-link">第 1 小节：什么是开源</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%9A%E5%88%9D%E8%AF%86%E5%BC%80%E6%BA%90/%E7%AC%AC%202%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%BC%80%E6%BA%90%E4%B8%8E%E4%B8%AA%E4%BA%BA%E6%8A%80%E6%9C%AF%E6%88%90%E9%95%BF/" class="sidebar-link">第 2 小节：开源与个人技术成长</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%9A%E5%88%9D%E8%AF%86%E5%BC%80%E6%BA%90/%E7%AC%AC%203%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%A6%82%E4%BD%95%E5%88%A4%E6%96%AD%E4%B8%80%E4%B8%AA%E9%A1%B9%E7%9B%AE%E6%98%AF%E5%90%A6%E6%98%AF%E5%BC%80%E6%BA%90%E7%9A%84/" class="sidebar-link">第 3 小节：如何判断一个项目是否是开源的</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%9A%E5%88%9D%E8%AF%86%E5%BC%80%E6%BA%90/%E7%AC%AC%204%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%85%B3%E4%BA%8E%E5%BC%80%E6%BA%90%E5%9F%BA%E9%87%91%E4%BC%9A/" class="sidebar-link">第 4 小节：关于开源基金会</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%9A%E5%88%9D%E8%AF%86%E5%BC%80%E6%BA%90/%E7%AC%AC%205%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E6%9C%89%E5%85%B3%E5%BC%80%E6%BA%90%E7%9A%84%E5%B8%B8%E8%A7%81%E8%AF%AF%E5%8C%BA/" class="sidebar-link">第 5 小节：有关开源的常见误区</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%9A%E5%88%9D%E8%AF%86%E5%BC%80%E6%BA%90/%E7%AC%AC%206%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%B8%B8%E8%A7%81%E6%96%87%E4%BB%B6%E8%AE%A4%E8%AF%86/" class="sidebar-link">第 6 小节：常见文件认识</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%9A%E5%88%9D%E8%AF%86%E5%BC%80%E6%BA%90/%E7%AC%AC%207%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E4%BC%81%E4%B8%9A%E8%A7%86%E8%A7%92%E7%9C%8B%E5%BE%85%E5%BC%80%E6%BA%90/" class="sidebar-link">第 7 小节：企业视角看待开源</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%9A%E5%88%9D%E8%AF%86%E5%BC%80%E6%BA%90/%E7%AC%AC%208%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%BC%80%E6%BA%90%E5%8F%91%E5%B1%95%E8%B6%8B%E5%8A%BF/" class="sidebar-link">第 8 小节：开源发展趋势</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><!----> <span>第二部分：学习和使用开源项目</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/presstest/%E7%AC%AC%E4%BA%8C%E9%83%A8%E5%88%86%EF%BC%9A%E5%AD%A6%E4%B9%A0%E5%92%8C%E4%BD%BF%E7%94%A8%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%201%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%A6%82%E4%BD%95%E6%89%BE%E5%88%B0%E9%80%82%E5%90%88%E8%87%AA%E5%B7%B1%E5%AD%A6%E4%B9%A0%E5%92%8C%E4%BD%BF%E7%94%A8%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/" class="sidebar-link">第 1 小节：如何找到适合自己学习和使用的开源项目</a></li><li><a href="/presstest/%E7%AC%AC%E4%BA%8C%E9%83%A8%E5%88%86%EF%BC%9A%E5%AD%A6%E4%B9%A0%E5%92%8C%E4%BD%BF%E7%94%A8%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%202%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E7%9A%84%E6%BA%90%E4%BB%A3%E7%A0%81%E8%AF%A5%E6%80%8E%E4%B9%88%E8%AF%BB/" class="sidebar-link">第 2 小节：开源项目的源代码该怎么读</a></li><li><a href="/presstest/%E7%AC%AC%E4%BA%8C%E9%83%A8%E5%88%86%EF%BC%9A%E5%AD%A6%E4%B9%A0%E5%92%8C%E4%BD%BF%E7%94%A8%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%203%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E8%AE%A4%E8%AF%86%E5%BC%80%E6%BA%90%E8%AE%B8%E5%8F%AF%E8%AF%81/" class="sidebar-link">第 3 小节：认识开源许可证</a></li><li><a href="/presstest/%E7%AC%AC%E4%BA%8C%E9%83%A8%E5%88%86%EF%BC%9A%E5%AD%A6%E4%B9%A0%E5%92%8C%E4%BD%BF%E7%94%A8%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%204%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%BC%80%E6%BA%90%E4%B8%AD%E7%9A%84%E8%B5%9E%E8%B5%8F%E6%96%87%E5%8C%96/" class="sidebar-link">第 4 小节：开源中的赞赏文化</a></li><li><a href="/presstest/%E7%AC%AC%E4%BA%8C%E9%83%A8%E5%88%86%EF%BC%9A%E5%AD%A6%E4%B9%A0%E5%92%8C%E4%BD%BF%E7%94%A8%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%205%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%A6%82%E4%BD%95%E6%89%BE%E5%88%B0%E6%9C%80%E5%BC%BA%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/" class="sidebar-link">第 5 小节：如何找到最强开源项目</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading open"><!----> <span>第三部分：尝试参与开源</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%201%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E4%B8%AD%E7%9A%84%E4%B8%8D%E5%90%8C%E8%A7%92%E8%89%B2/" class="sidebar-link">第 1 小节：开源项目中的不同角色</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%202%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E4%B8%AA%E4%BA%BA%E4%B8%BA%E4%BB%80%E4%B9%88%E8%A6%81%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90%E8%B4%A1%E7%8C%AE/" class="sidebar-link">第 2 小节：个人为什么要参与开源贡献</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%203%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E4%BC%81%E4%B8%9A%E4%B8%BA%E4%BB%80%E4%B9%88%E8%A6%81%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/" class="sidebar-link">第 3 小节：企业为什么要参与开源</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%204%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%8F%AF%E4%BB%A5%E7%94%A8%E5%93%AA%E4%BA%9B%E6%96%B9%E5%BC%8F%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/" class="sidebar-link">第 4 小节：可以用哪些方式参与开源</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%205%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%A6%82%E4%BD%95%E6%89%BE%E5%88%B0%E9%80%82%E5%90%88%E7%9A%84%E9%A1%B9%E7%9B%AE%E8%BF%9B%E8%A1%8C%E8%B4%A1%E7%8C%AE/" class="sidebar-link">第 5 小节：如何找到适合的项目进行贡献</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%206%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E6%8F%90%E4%BA%A4%E7%AC%AC%E4%B8%80%E4%B8%AA%20Issue/" aria-current="page" class="active sidebar-link">第 6 小节：提交第一个 Issue</a><ul class="sidebar-sub-headers"></ul></li><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%207%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E6%8F%90%E4%BA%A4%E7%AC%AC%E4%B8%80%E4%B8%AA%20Pull%20Request/" class="sidebar-link">第 7 小节：提交第一个 Pull Request</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%208%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%A6%82%E4%BD%95%E6%88%90%E4%B8%BA%E4%B8%80%E4%B8%AA%E9%A1%B9%E7%9B%AE%E7%9A%84%E6%A0%B8%E5%BF%83%E8%B4%A1%E7%8C%AE%E8%80%85/" class="sidebar-link">第 8 小节：如何成为一个项目的核心贡献者</a></li><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%209%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E7%9A%84%E8%B4%A1%E7%8C%AE%E5%87%86%E5%88%99%E5%92%8C%E8%B4%A1%E7%8C%AE%E8%80%85%E5%85%AC%E7%BA%A6/" class="sidebar-link">第 9 小节：开源项目的贡献准则和贡献者公约</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><!----> <span>第四部分：启动自己的开源项目</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/presstest/%E7%AC%AC%E5%9B%9B%E9%83%A8%E5%88%86%EF%BC%9A%E5%90%AF%E5%8A%A8%E8%87%AA%E5%B7%B1%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%201%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E6%9C%89%E4%BA%86%E5%BC%80%E6%BA%90%E7%9A%84%E6%83%B3%E6%B3%95%E5%90%8E%E4%BB%8E%E4%BD%95%E5%BC%80%E5%A7%8B/" class="sidebar-link">第 1 小节：有了开源的想法后从何开始</a></li><li><a href="/presstest/%E7%AC%AC%E5%9B%9B%E9%83%A8%E5%88%86%EF%BC%9A%E5%90%AF%E5%8A%A8%E8%87%AA%E5%B7%B1%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%202%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E4%B8%BA%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E5%BB%BA%E7%AB%8B%E8%89%AF%E5%A5%BD%E7%9A%84%E5%9F%BA%E7%A1%80/" class="sidebar-link">第 2 小节：为开源项目建立良好的基础</a></li><li><a href="/presstest/%E7%AC%AC%E5%9B%9B%E9%83%A8%E5%88%86%EF%BC%9A%E5%90%AF%E5%8A%A8%E8%87%AA%E5%B7%B1%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%203%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%BC%80%E6%BA%90%E8%AE%B8%E5%8F%AF%E8%AF%81%E7%9A%84%E5%BA%94%E7%94%A8/" class="sidebar-link">第 3 小节：开源许可证的应用</a></li><li><a href="/presstest/%E7%AC%AC%E5%9B%9B%E9%83%A8%E5%88%86%EF%BC%9A%E5%90%AF%E5%8A%A8%E8%87%AA%E5%B7%B1%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%204%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E4%B8%BA%E8%87%AA%E5%B7%B1%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E5%BB%BA%E7%AB%8B%E8%B4%A1%E7%8C%AE%E5%87%86%E5%88%99/" class="sidebar-link">第 4 小节：为自己的开源项目建立贡献准则</a></li><li><a href="/presstest/%E7%AC%AC%E5%9B%9B%E9%83%A8%E5%88%86%EF%BC%9A%E5%90%AF%E5%8A%A8%E8%87%AA%E5%B7%B1%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%205%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E7%9A%84%E7%BB%B4%E6%8A%A4%E5%92%8C%E7%AE%A1%E7%90%86/" class="sidebar-link">第 5 小节：开源项目的维护和管理</a></li><li><a href="/presstest/%E7%AC%AC%E5%9B%9B%E9%83%A8%E5%88%86%EF%BC%9A%E5%90%AF%E5%8A%A8%E8%87%AA%E5%B7%B1%E7%9A%84%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE/%E7%AC%AC%206%20%E5%B0%8F%E8%8A%82%EF%BC%9ACONTRIBUTING%20%E7%BC%96%E5%86%99/" class="sidebar-link">第 6 小节：CONTRIBUTING 编写</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><!----> <span>第五部分：开源治理</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/presstest/%E7%AC%AC%E4%BA%94%E9%83%A8%E5%88%86%EF%BC%9A%E5%BC%80%E6%BA%90%E6%B2%BB%E7%90%86/%E7%AC%AC%201%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E4%B8%AA%E4%BA%BA%E7%BB%B4%E6%8A%A4%E5%92%8C%E5%BB%BA%E7%AB%8B%E7%A4%BE%E5%8C%BA%EF%BC%8C%E4%B8%A4%E8%80%85%E5%A6%82%E4%BD%95%E9%80%89%E6%8B%A9/" class="sidebar-link">第 1 小节：个人维护和建立社区，两者如何选择</a></li><li><a href="/presstest/%E7%AC%AC%E4%BA%94%E9%83%A8%E5%88%86%EF%BC%9A%E5%BC%80%E6%BA%90%E6%B2%BB%E7%90%86/%E7%AC%AC%202%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E6%89%93%E9%80%A0%E5%BC%80%E6%BA%90%E7%A4%BE%E5%8C%BA/" class="sidebar-link">第 2 小节：打造开源社区</a></li><li><a href="/presstest/%E7%AC%AC%E4%BA%94%E9%83%A8%E5%88%86%EF%BC%9A%E5%BC%80%E6%BA%90%E6%B2%BB%E7%90%86/%E7%AC%AC%203%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E7%9A%84%E5%B8%B8%E8%A7%81%E6%B2%BB%E7%90%86%E6%9E%B6%E6%9E%84/" class="sidebar-link">第 3 小节：开源项目的常见治理架构</a></li><li><a href="/presstest/%E7%AC%AC%E4%BA%94%E9%83%A8%E5%88%86%EF%BC%9A%E5%BC%80%E6%BA%90%E6%B2%BB%E7%90%86/%E7%AC%AC%204%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E7%A1%AE%E4%BF%9D%E5%BC%80%E6%BA%90%E4%BB%A3%E7%A0%81%E8%B4%A8%E9%87%8F%E7%9A%84%E5%87%A0%E4%B8%AA%E8%A6%81%E7%82%B9/" class="sidebar-link">第 4 小节：确保开源代码质量的几个要点</a></li></ul></section></li><li><section class="sidebar-group depth-0"><p class="sidebar-heading"><!----> <span>第六部分：有关开源的其他问题</span> <!----></p> <ul class="sidebar-links sidebar-group-items"><li><a href="/presstest/%E7%AC%AC%E5%85%AD%E9%83%A8%E5%88%86%EF%BC%9A%E5%85%B6%E4%BB%96%E9%97%AE%E9%A2%98/%E7%AC%AC%201%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E6%80%8E%E6%A0%B7%E5%9C%A8%E6%9C%AC%E8%81%8C%E5%B7%A5%E4%BD%9C%E5%92%8C%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E9%97%B4%E5%81%9A%E5%A5%BD%E5%B9%B3%E8%A1%A1/" class="sidebar-link">第 1 小节：怎样在本职工作和开源项目间做好平衡</a></li><li><a href="/presstest/%E7%AC%AC%E5%85%AD%E9%83%A8%E5%88%86%EF%BC%9A%E5%85%B6%E4%BB%96%E9%97%AE%E9%A2%98/%E7%AC%AC%202%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E5%85%B3%E4%BA%8E%E5%BC%80%E6%BA%90%E9%A1%B9%E7%9B%AE%E7%9A%84%E5%95%86%E4%B8%9A%E5%8C%96/" class="sidebar-link">第 2 小节：关于开源项目的商业化</a></li></ul></section></li></ul> </aside> <main class="page"><nav class="breadcrumb"><ul><li><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/" class="router-link-active"><i class="iconfont icon-page"></i>
        第三部分：尝试参与开源
      </a></li><li class="is-active"><a href="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%206%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E6%8F%90%E4%BA%A4%E7%AC%AC%E4%B8%80%E4%B8%AA%20Issue/" aria-current="page" class="router-link-exact-active router-link-active"><!---->
        第 6 小节：提交第一个 Issue
      </a></li></ul></nav>  <div class="page-title"><h1><!---->
    第 6 小节：提交第一个 Issue
  </h1> <div class="page-info"><!----> <span aria-label="Author🖊" data-balloon-pos="down"><svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" class="icon author-icon"><path d="M649.6 633.6c86.4-48 147.2-144 147.2-249.6 0-160-128-288-288-288s-288 128-288 288c0 108.8 57.6 201.6 147.2 249.6-121.6 48-214.4 153.6-240 288-3.2 9.6 0 19.2 6.4 25.6 3.2 9.6 12.8 12.8 22.4 12.8h704c9.6 0 19.2-3.2 25.6-12.8 6.4-6.4 9.6-16 6.4-25.6-25.6-134.4-121.6-240-243.2-288z" fill="currentColor"></path></svg> <span>开源指北编写小组</span></span><span aria-label="Page views🔢" data-balloon-pos="down" class="visitor-info"><svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" class="icon eye-icon"><path d="M992 512.096c0-5.76-.992-10.592-1.28-11.136-.192-2.88-1.152-8.064-2.08-10.816-.256-.672-.544-1.376-.832-2.08-.48-1.568-1.024-3.104-1.6-4.32C897.664 290.112 707.104 160 512 160c-195.072 0-385.632 130.016-473.76 322.592-1.056 2.112-1.792 4.096-2.272 5.856a55.512 55.512 0 00-.64 1.6c-1.76 5.088-1.792 8.64-1.632 7.744-.832 3.744-1.568 11.168-1.568 11.168-.224 2.272-.224 4.032.032 6.304 0 0 .736 6.464 1.088 7.808.128 1.824.576 4.512 1.12 6.976h-.032c.448 2.08 1.12 4.096 1.984 6.08.48 1.536.992 2.976 1.472 4.032C126.432 733.856 316.992 864 512 864c195.136 0 385.696-130.048 473.216-321.696 1.376-2.496 2.24-4.832 2.848-6.912.256-.608.48-1.184.672-1.728 1.536-4.48 1.856-8.32 1.728-8.32l-.032.032c.608-3.104 1.568-7.744 1.568-13.28zM512 672c-88.224 0-160-71.776-160-160s71.776-160 160-160 160 71.776 160 160-71.776 160-160 160z" fill="currentColor"></path></svg> <span id="/presstest/%E7%AC%AC%E4%B8%89%E9%83%A8%E5%88%86%EF%BC%9A%E5%B0%9D%E8%AF%95%E5%8F%82%E4%B8%8E%E5%BC%80%E6%BA%90/%E7%AC%AC%206%20%E5%B0%8F%E8%8A%82%EF%BC%9A%E6%8F%90%E4%BA%A4%E7%AC%AC%E4%B8%80%E4%B8%AA%20Issue/" data-flag-title="第 6 小节：提交第一个 Issue" class="leancloud_visitors"><span class="leancloud-visitors-count">...</span></span></span><!----><!----><!----><span aria-label="Reading Time⌛" data-balloon-pos="down" class="read-time-info"><svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" class="icon time-icon"><path d="M511.997 70.568c-243.797 0-441.429 197.633-441.429 441.435 0 243.797 197.632 441.429 441.43 441.429S953.431 755.8 953.431 512.002c0-243.796-197.637-441.434-441.435-441.434zm150.158 609.093l-15.605 15.61c-8.621 8.615-22.596 8.615-31.215 0L472.197 552.126c-4.95-4.944-4.34-14.888-4.34-24.677V247.14c0-12.19 9.882-22.07 22.07-22.07h22.07c12.19 0 22.07 9.882 22.07 22.07v273.218l128.088 128.088c8.62 8.62 8.62 22.595 0 31.215zm0 0" fill="currentColor"></path></svg> <span>About 17 min</span></span></div> <hr></div> <!----> <div class="anchor-place-holder"><aside id="anchor"><div class="anchor-wrapper"><ul class="anchor-list"></ul></div></aside></div> <div class="theme-default-content content__default"><h1 id="第-6-小节-提交第一个-issue"><a href="#第-6-小节-提交第一个-issue" class="header-anchor">#</a> 第 6 小节：提交第一个 Issue</h1> <h3 id="什么是-issue"><a href="#什么是-issue" class="header-anchor">#</a> 什么是 Issue</h3> <p>Issue 的翻译大致为<strong>议题</strong>、<strong>问题</strong>。</p> <p><img src="https://images.gitee.com/uploads/images/2020/1103/095504_32fddf55_1277510.png" alt="issue的翻译" title="image-20201030195145149.png"></p> <p>为了方便你理解，我们更愿意把它称之为<strong>待办清单</strong>、<strong>问题或 Bug 列表</strong>、<strong>讨论版</strong>等等。相信这些称呼会让你更容易理解什么是 Issue。</p> <p>这是一种伟大的协作方式，让你可以更方便的对整个仓库进行跟踪、增强和排错<sup>[1]</sup>。对于一个公开的仓库来说，Issue 是向所有人开放的，不仅仓库的所有者可以给自己提 Issue，其他人也可以对项目提 Issue。</p> <p>而根据 Gitee 官方的建议，项目相关的技术问题、缺陷报告、建议等信息都可以通过 Issue 进行发布。</p> <h3 id="什么情况下需要提交-issue"><a href="#什么情况下需要提交-issue" class="header-anchor">#</a> 什么情况下需要提交 Issue</h3> <p>那么什么情况下需要提交 Issue 呢？</p> <p>常见的 Issue 面板的使用会有以下几种方式：</p> <ol><li><p><strong>待办清单 TO DO LIST</strong></p> <p>比如你要写一本书，共分为八个章节，你选择使用 Gitee 来管理你的书籍电子稿。那么你需要提前想好每一章节的标题，以及每个章节内的每个小节需要写点什么，并列个提纲。此时，你可以将每一个小节想好要写的大致脉络分别提一个 Issue，用来提醒自己未来要做的事情。（这也是你正在看的这本<code>开源指北</code>的协作方式）完成后，你只需要按照规划，将每一个 Issue 中所提到的编写任务完成，你的云端书籍也就完成了。</p></li> <li><p><strong>问题列表 BUG LIST</strong></p> <p>一个复杂的项目难免会有这样或那样的 Bug，而这些内容被观摩你仓库的朋友们发现之后，可以通过 Issue 给你提出，你可以根据他们指出的复现步骤来定位问题，并最终修复，让你所编写的项目更加健壮而强大。不要害怕自己代码写得很烂，感觉别人提 Bug 就是在揭自己的短什么的，因为每发现一个 Bug 意味着你的程序又少了一个缺陷，只需要快速修复它即可。当然，你也可以自己发现 Bug，并给自己提出 Issue，目的是让自己的项目有充分的留痕，便于后续避免该问题或寻找解决方案。</p></li> <li><p><strong>讨论版 BBS</strong></p> <p>可以完全将 Issue 模块当做你的仓库的私人论坛、私人社区来使用。围绕你的项目，你可以做如下的事情：</p> <ul><li>提出你下一阶段想要添加的功能，请大家集思广益，这样会非常有利于知识和技术的沉淀，即使是当时没有参加讨论的开发者，事后也可以通过该 Issue 了解进行此功能设计的前因后果。</li> <li>其他人有事想对作者询问、探讨，或咨询如何使用</li> <li>其他人想要作者添加点新功能，提出来跟作者讨论讨论</li> <li>甚至，你也可以在 Issue 里给广大开发者提跟你的仓库内容完全无关的事情，比如：<code>求助！女朋友生气了要怎么哄？</code></li></ul></li></ol> <p>当然，第三点的前提是<strong>这是你自己的仓库</strong>，如果是他人的仓库，请遵守其作者对于 Issue 板块的要求和规定。前文也提到，根据 Gitee 官方的建议，可以通过 Issue 进行发布的内容包括项目相关的技术问题、缺陷报告、建议等信息，这一点请开发者们着重注意，避免一些项目外的信息影响 Issue 板块的正常讨论。</p> <p>所以，总结下来，可以有如下结论：</p> <ul><li>对于你自己来说，可以使用 Issue 来发布待办清单，给自己提开发任务或 Bug，开帖找大家探讨项目下一步的发展方向等等。当然，你也可以用它来提出一些跟仓库内容无关的事情，这也是允许的。</li> <li>如果你想要提 Issue 的仓库不是你自己的，而是他人的的时候，Issue 就是一个很好的多人协作系统。比如发现了别人项目的 Bug 的时候；比如想要别人添加某个新功能的时候；比如有使用上的困难，需要求助作者使用步骤的时候，你都可以给别人的仓库提出 Issue。同时，如果你是一个热心的开发者，你也可以帮助原作者回答一些别人提出的 Issue，这样的行为可以极大地帮助原作者分担压力哦。不要觉得自己是在做临时免费工，解答的过程中你的知识和技术也会得到巩固和提高，有时还能结交到许多志同道合的好朋友哦。我助人，人亦助我。</li></ul> <h3 id="一个好的-issue-应该写些什么"><a href="#一个好的-issue-应该写些什么" class="header-anchor">#</a> 一个好的 Issue 应该写些什么</h3> <p>那么一个好的 Issue 应该写点什么呢？</p> <p>这一点对于外部协作者来说尤为重要，因为你要提的 Issue 不是在自己的地盘上，而是需要得到别人的帮助的，所以你尤其要注意 Issue 的礼仪。</p> <h4 id="issue-的礼仪-2"><a href="#issue-的礼仪-2" class="header-anchor">#</a> Issue 的礼仪<sup>[2]</sup></h4> <ol><li>提问使用的语言：在主要面向母语为中文的开发者的开源平台，首选中文。在其他开源平台，首选仓库维护者的母语进行交流，如果不确定或有困难，建议选择英文交流。</li> <li>提问态度和语气：因为你面对的是跟你一样的开发者，不卑不亢，虚心求教就可以了，不必要太咋呼，措辞太夸张等。但是言语之间要表示对作者的尊重，最好多使用<code>请</code>、<code>谢谢</code>、<code>Please</code>、<code>Thanks</code>等词语。</li> <li><strong>如有 Issue 模板，请参照模板写 Issue</strong>。如果原作者定义了 Issue 模板，请按模板来写，避免挤牙膏式的交流。如没有，本文会有比较通用的模板提供给大家。总之，撰写的原则是，把事情表述清楚，便于原作者处理和与你交流。</li></ol> <h4 id="一个好-issue-的标准-2"><a href="#一个好-issue-的标准-2" class="header-anchor">#</a> 一个好 Issue 的标准<sup>[2]</sup></h4> <ol><li>避免使用术语或晦涩的文字，尽量不要堆砌术语即可，不是说禁止使用术语；</li> <li>问题可以切分，也就是说可以逐步解决的问题；</li> <li>尽量跟其他问题没有瓜葛，依赖其它问题会降低处理的灵活性；</li> <li>可以协商，也就说我们有好几种办法达到目标；</li> <li>问题足够小，可以非常容易的评估出所需时间和资源；</li> <li>可衡量，我们可以对结果进行测试。</li></ol> <blockquote><p>如果你是仓库的拥有者，你还可以编写一个 <code>CONTRIBUTE.md</code> 文件放在项目中，用来告知其他开发者需要如何参与你的项目。</p></blockquote> <h4 id="issue-的标题怎么写-2"><a href="#issue-的标题怎么写-2" class="header-anchor">#</a> Issue 的标题怎么写？<sup>[2]</sup></h4> <p>格式：<code>[分类、标签或某文件名] + 简短描述</code></p> <p>先使用方括号（也可以使用<code>【】</code>替代方括号），里面写上分类、标签或某文件名（比如这个文件有问题待修改），这部分是便于作者进行问题分类的，也方便其他协作者查找（很多人提 Issue 并没有这一部分，建议加上）。然后使用简短的描述，可以让人通过标题快速了解这个 Issue 是讲什么内容的。</p> <p>案例：<code>[Bug]app.py文件 173 行运行报错，疑似遗漏一个=号</code></p> <h4 id="提出一个-issue"><a href="#提出一个-issue" class="header-anchor">#</a> 提出一个 Issue</h4> <p>咱们先来给一个 Gitee 官方通用的模板：</p> <div class="language-markdown line-numbers-mode"><pre class="language-markdown"><code><span class="token title important"><span class="token punctuation">###</span> 该问题是怎么引起的？</span>



<span class="token title important"><span class="token punctuation">###</span> 重现步骤</span>



<span class="token title important"><span class="token punctuation">###</span> 报错信息</span>
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br></div></div><p>你可以按照模板来补充 Issue 内容，如果你有更详细的描述，当然也可以扩充模板。如果作者有提供 Issue 模板，请按照作者规定的模板提，这样可以方便作者对问题进行后续整理。</p> <blockquote><p>Gitee 在提 Issue 时是支持 Markdown 格式的，它让我们提出的 Issue 能有更加丰富的内容展现。</p></blockquote> <p>在 Gitee 中，支持在新建仓库时创建 Issue 模板，也支持自定义模板。</p> <p>在新建仓库时，勾选<code>使用 Issue 模板文件初始化这个项目</code>，实际上就是在仓库根目录下新建了 <code>.gitee/ISSUE_TEMPLATE.zh-CN.md</code> 文件，当然你也可以自己创建这个文件，来编写自己的模板。</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/184559_3f5d281c_1277510.png" alt="选择使用模板来初始化项目" title="image-20201104183636294.png"></p> <p>自己创建 Issue 模板，可在仓库中创建<code>.gitee</code>目录，并创建对应的模板文件：</p> <ol><li><code>.gitee/ISSUE_TEMPLATE.zh-CN.md</code>，Issue 中文模板</li> <li><code>.gitee/ISSUE_TEMPLATE.en.md</code>，Issue 英文模板</li> <li><code>.gitee/ISSUE_TEMPLATE.zh-TW.md</code>，Issue 繁体模板</li></ol> <blockquote><p>Q: 不同类型的模板，有什么作用？</p> <p>A: 例如你的仓库中有 3 种语言类型的 Issue 模板，提交 Issue 的用户使用的是英文版，那么当用户勾选<code>使用 Issue 模板</code>，则会智能地使用英文模板，如果对方使用的是中文版则会智能地使用中文 Issue 模板。</p></blockquote> <p>当你在敲标题或者 Issue 内容时，项目会自动显示已有的类似 Issue，你可以先查看一下推荐的 Issue 能否解决你的问题，如果不能再提出，避免反复提出同一个问题。</p> <p>好了，当你完成 Issue 主体内容的填写之后，快去提交给作者吧！</p> <h3 id="issue-案例-有价值和无价值"><a href="#issue-案例-有价值和无价值" class="header-anchor">#</a> Issue 案例（有价值和无价值）</h3> <p>下面我们来看几个 Issue 的案例。</p> <p><strong>无价值：</strong></p> <p><a href="https://gitee.com/sentsin/layui/issues/I1SS5Z" target="_blank" rel="noopener noreferrer">https://gitee.com/sentsin/layui/issues/I1SS5Z<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <p><img src="https://images.gitee.com/uploads/images/2020/1103/095610_3fe4df54_1277510.png" alt="无价值案例 1" title="image-20201102230656555.png"></p> <p>该案例的标题仅两个字<code>表格</code>，作者如果不点进 Issue 的具体内容则无法获知到底这个 Issue 说的是什么。属于无价值案例。</p> <hr> <p><a href="https://gitee.com/sentsin/layui/issues/I1PQVC" target="_blank" rel="noopener noreferrer">https://gitee.com/sentsin/layui/issues/I1PQVC<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <p><img src="https://images.gitee.com/uploads/images/2020/1103/095627_8b4fadf6_1277510.png" alt="无价值案例 2" title="image-20201102230927454.png"></p> <p>该案例最抓人眼球的应该是那一长串的<code>!</code>号，画面都快容不下了，而且作者在看这样的标题的时候也无法获知到底是个什么问题，有一种过分夸张的感觉。属于无价值案例。</p> <hr> <p><strong>有价值：</strong></p> <p><a href="https://gitee.com/sentsin/layui/issues/I1OFU3" target="_blank" rel="noopener noreferrer">https://gitee.com/sentsin/layui/issues/I1OFU3<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <p><img src="https://images.gitee.com/uploads/images/2020/1103/095655_074d520b_1277510.png" alt="有价值案例 1" title="image-20201102231303010.png"></p> <p>标题清晰明了，作者可以轻松获知 Issue 的主体内容。内容贴出了自己尝试的代码，便于作者提供帮助。属于有价值案例。</p> <hr> <p><a href="https://gitee.com/sentsin/layui/issues/I1OD1P" target="_blank" rel="noopener noreferrer">https://gitee.com/sentsin/layui/issues/I1OD1P<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <p><img src="https://images.gitee.com/uploads/images/2020/1103/095715_67d435b1_1277510.png" alt="有价值案例 2" title="image-20201102231520201.png"></p> <p>该案例同样使用了清晰明了的标题表述形式，内容中还具体贴出了自己尝试的代码，便于作者提供帮助或定位问题。属于有价值案例。</p> <hr> <p>从上面的几个简单的案例来看，我们发现无价值的案例都有过分夸张、需要表达的观点或内容不清晰等问题。</p> <p>而有价值的案例，既能在标题中精准反馈某一个点的问题，又能在内容中贴出自己尝试的代码和想法，便于作者提供帮助。</p> <p>因此，Issue 的精准表述是能获得良好协作的基础，提 Issue 也是一种很好的练习表达的方式。</p> <h3 id="issue-的进阶使用"><a href="#issue-的进阶使用" class="header-anchor">#</a> Issue 的进阶使用</h3> <p>掌握了 Issue 的基础使用之后，作为一个优秀的开发者，我们还可以掌握一些进阶的知识，它能让你压榨干净 Issue 的每一分价值。</p> <h4 id="issue-的详细设置"><a href="#issue-的详细设置" class="header-anchor">#</a> Issue 的详细设置</h4> <p>如果仓库是你自己的，你可以在每一个 Issue 的面板看到更多的进阶选项，如图所示：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/121602_7f774b18_1277510.png" alt="Issue的进阶设置" title="image-20201103110330425.png"></p> <ul><li><p><strong>负责人</strong>：负责人指的是谁来负责处理这个 Issue，可以设置用户为负责人或协作者。对于个人版来说，只能选择自己。如果是组织或者企业，可以指派他人。同一个 Issue 仅能有一个负责人，但问题可能由多个人协作解决，所以可以添加多个协作者。其它权限是一样的。对于企业版用户来说，设置负责人可以很好地统计任务完成情况（个人版无此功能，因此负责人也可以不设置），如图所示：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/121656_f6ccd9c7_1277510.png" alt="组织或企业的负责人选择" title="image-20201103154930390.png"></p> <p>企业版中可根据负责人统计任务完成信息：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/121732_dd5fd2c8_1277510.png" alt="企业版中可根据负责人统计任务完成信息" title="image-20201103155036529.png"></p></li> <li><p><strong>标签</strong>：高质量的 Issue 是项目成功的关键。有些人把 Issue 仅仅看作是一堆你不得不去处理的问题列表，但是如果这些问题单管理完善，进行了分类并打上标签，会令人意想不到的提升我们对代码和社区的了解程度，也让我们更清楚问题的关键点在哪里。<sup>[2]</sup>将标签完善之后，不管是仓库所有者还是其他人都可以快速定位含有某标签的 Issue，协作的效率也将大大提高。</p> <p>在 Gitee 中，Issue 中的<strong>标签</strong>支持修改原有标签名称、从其它项目导入标签以及新增自定义标签等。一个默认的仓库会有如下一些默认的标签<sup>[2]</sup><sup>[3]</sup>：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/121827_6dd23a40_1277510.png" alt="Issue中的默认标签" title="image-20201103210736651.png"></p> <p>如果默认的标签不够你使用，你可以添加你的自定义标签。只需要点击右上角的<code>+</code>号即可。</p></li> <li><p><strong>项目</strong>：项目仅企业版用户可以关联，个人版或组织在这一项可以忽略掉。企业版用户可以根据下面的图片来了解如何创建一个项目，以及如何找到新创建的项目。当项目创建之后，就可以关联到某个 Issue 了。</p> <p>先进入企业面板，进入所在企业：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/121905_7de2c1b7_1277510.png" alt="先进入企业面板，进入所在企业" title="image-20201103211346712.png"></p> <p>右上角新建项目可以新建：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/121940_60a50a92_1277510.png" alt="右上角新建项目可以新建" title="image-20201103211512199.png"></p> <p>查看新建的项目：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/122018_2ef66098_1277510.png" alt="查看新建的项目" title="image-20201103211600514.png"></p></li> <li><p><strong>里程碑</strong>：里程碑是某功能或某个时间段的一堆问题的集合。比如我们要写一本书，一个章节如果设置为一个里程碑，那这个章节里面的每一个小节我们就可以分别提多个 Issue，最后将这些 Issue 关联到这个章节的里程碑中，方便管理，可以很容易看到整个章节的完成进度。我们可以根据自己的需要，来使用里程碑的功能。下面是一些使用里程碑功能的例子<sup>[1]</sup>：</p> <ul><li><strong>发布测试</strong>——在你发布项目的 Beta 版之前，包含你需要修复的 Bug 文件相关的 Issue。这样可以确保你不会漏掉什么。</li> <li><strong>十月冲刺</strong>——记录你在十月份应该做的问题清单。相当于一个工作清单，时刻提醒你应该重点完成哪些工作。（当然，你设定一个九月要做的事情的清单也是可以的）</li> <li><strong>重新设计</strong>——记录与重新设计项目的问题清单。这是一种收集灵感的好方法。</li></ul> <blockquote><p>如何创建自己的里程碑？（所有用户均可创建）</p></blockquote> <p>新建里程碑：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/122051_3d9f8f40_1277510.png" alt="新建里程碑" title="image-20201104104505287.png"></p> <p>新建完成后即可在 Issue 中关联：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/122123_f025a6a2_1277510.png" alt="新建完成后即可在 Issue 中关联" title="image-20201104104609496.png"></p></li> <li><p><strong>关联分支</strong>：这里可以选择关联到该仓库的哪个分支。</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/122205_fa7de81b_1277510.png" alt="选择关联分支" title="image-20201104115955351.png"></p></li> <li><p><strong>计划开始日期</strong>：该 Issue 计划开始处理的日期。</p></li> <li><p><strong>计划截止日期</strong>：该 Issue 计划截止处理的日期。</p></li> <li><p><strong>置顶选项</strong>：该 Issue 在 Issue 列表中的置顶级别。</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/122231_61ed06f5_1277510.png" alt="置顶选项" title="image-20201104120147079.png"></p></li> <li><p><strong>优先级</strong>：该问题的严重程度，优先处理级别。</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/122301_aeea5b92_1277510.png" alt="优先级" title="image-20201104120303417.png"></p></li></ul> <h4 id="issue-的状态和看板"><a href="#issue-的状态和看板" class="header-anchor">#</a> Issue 的状态和看板</h4> <p>Issue 在提出之后，对于个人版来说可以有四种状态：待办的、进行中、已完成、已拒绝。负责人或者协作者可以修改该状态。企业版会可选更多的状态。</p> <blockquote><p>状态变更之后，允许再次变更，比如设置为<code>已完成</code>状态的 Issue，可以再次修改为<code>进行中</code>。</p></blockquote> <p><img src="https://images.gitee.com/uploads/images/2020/1104/122341_7c087174_1277510.png" alt="Issue 的状态切换" title="image-20201104120709716.png"></p> <p>我们还可以在<code>看板</code>中看到处于每种状态的 Issue 的列表。</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/122400_f9648c84_1277510.png" alt="看板页面" title="image-20201104120934433.png"></p> <h4 id="提及别人"><a href="#提及别人" class="header-anchor">#</a> @ 提及别人</h4> <p>使用<code>@</code>符号可以在 Issue 提出或者问题讨论的过程中提及别人，起到被 <code>艾特</code>的效果。</p> <h4 id="关联其他-issue"><a href="#关联其他-issue" class="header-anchor">#</a> # 关联其他 Issue</h4> <p>使用<code>#</code>符号再加上其他 Issue 的编号，可以关联到其它的 Issue。找到本仓库下 Issue 的编号之后写上即可。</p> <p>找到 Issue 编号（这里为 <code>#I23WUE</code>）：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/151115_93315a5e_1277510.png" alt="找到 Issue 编号" title="image-20201104141131901.png"></p> <p>支持快速点击，提交 Issue 之后会自动生成链接，链接到该 Issue：</p> <p><img src="https://images.gitee.com/uploads/images/2020/1104/151142_abdbc1da_1277510.png" alt="支持快速点击" title="image-20201104141338952.png"></p> <h4 id="通过筛选器快速找到-issue"><a href="#通过筛选器快速找到-issue" class="header-anchor">#</a> 通过筛选器快速找到 Issue</h4> <p>可以通过搜索框输入关键词搜索 Issue，也可以通过下方的一些搜索条件来搜索 Issue。有了筛选器，当我们的 Issue 非常多时，我们就可以在众多的 Issue 中找到自己需要的 Issue 了。</p> <blockquote><p>当你将各种 Issue 维护好对应的标签之后，可以快速找到属于某个标签的 Issue 结果进行处理。</p></blockquote> <p><img src="https://images.gitee.com/uploads/images/2020/1104/151211_cfa06098_1277510.png" alt="快速搜索 Issue" title="image-20201104142549944.png"></p> <h4 id="在-commit-中关闭-issue"><a href="#在-commit-中关闭-issue" class="header-anchor">#</a> 在 Commit 中关闭 Issue</h4> <p>比如在修复一个 Bug 时，某一次 Commit 就是解决了提这个 Bug 的 Issue 的，那么我们可以轻松的在 Commit 的内容中附带上一些特殊信息（在 Commit 信息中或者附加信息中均可），来自动关闭 Issue。</p> <p>Gitee 支持的提交方式有（比如我们需要关闭的 Issue 编号为 24，<code>+</code>号表示在提交的内容中添加后面部分的内容）<sup>[4]</sup>：</p> <div class="language-markdown line-numbers-mode"><pre class="language-markdown"><code><span class="token title important"><span class="token punctuation">#</span> 任选其一即可！</span>
<span class="token list punctuation">+</span> fix #24
<span class="token list punctuation">+</span> fixed #24
<span class="token list punctuation">+</span> close #24
<span class="token list punctuation">+</span> closes #24
<span class="token list punctuation">+</span> closing #24
<span class="token list punctuation">+</span> closed #24
<span class="token list punctuation">+</span> resolved #24
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br></div></div><p><img src="https://images.gitee.com/uploads/images/2020/1104/151238_25c34fd1_1277510.png" alt="在提交的内容中添加关闭 Issue 的信息" title="image-20201104144448225.png"></p> <h4 id="issue-中的待办清单"><a href="#issue-中的待办清单" class="header-anchor">#</a> Issue 中的待办清单</h4> <p>不知道大家是否在 Issue 中有一些任务需要分步骤完成呢？如下面示例的 Issue，可以实现待办清单的功效<sup>[4]</sup>。可以根据后续的需要，勾选或者取消勾选待办清单中的分项任务，实现 checklist 的效果。</p> <blockquote><p>勾选或取消勾选后，刷新页面或者关闭该 Issue 页面重新打开，选择的状态依然存在，而且这种操作会保存到该 Issue 的操作日志当中去。修改状态，不再需要重新编辑该 Issue 了，非常的方便。</p></blockquote> <p><img src="https://images.gitee.com/uploads/images/2020/1104/151304_d991149d_1277510.png" alt="Issue待办清单效果演示" title="image-20201104150040988.png"></p> <p>那么，需要拥有这样的待办清单，提 Issue 的时候应该怎么写呢？请看代码：</p> <div class="language-markdown line-numbers-mode"><pre class="language-markdown"><code>通过特有的语法可以实现待办清单的功效，修改待办清单里面的项目是否完成无需再打开 Issue 的编辑界面了！

<span class="token list punctuation">*</span> [x] 吃早餐

<span class="token list punctuation">*</span> [ ] 吃午餐

<span class="token list punctuation">*</span> [ ] 吃晚餐
</code></pre> <div class="line-numbers-wrapper"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br></div></div><p>通过<code>* [x]</code>来创建已勾选的事项，通过<code>* [ ]</code>来创建未勾选的事项即可。</p> <blockquote><p>请注意，设置未勾选状态时，方括号之间会有一个空格<code>[ ]</code>，不要漏掉了。</p></blockquote> <h3 id="参考资料"><a href="#参考资料" class="header-anchor">#</a> 参考资料</h3> <p>[1] <a href="https://guides.github.com/features/issues/" target="_blank" rel="noopener noreferrer">https://guides.github.com/features/issues/<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <p>[2] <a href="https://zhuanlan.zhihu.com/p/75691927" target="_blank" rel="noopener noreferrer">https://zhuanlan.zhihu.com/p/75691927<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <p>[3] <a href="https://blog.csdn.net/lovewinner/article/details/80763629" target="_blank" rel="noopener noreferrer">https://blog.csdn.net/lovewinner/article/details/80763629<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <p>[4] <a href="https://www.jianshu.com/p/5ba1e7f5ad70" target="_blank" rel="noopener noreferrer">https://www.jianshu.com/p/5ba1e7f5ad70<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p> <h3 id="本部分内容贡献者"><a href="#本部分内容贡献者" class="header-anchor">#</a> 本部分内容贡献者</h3> <p><a href="https://gitee.com/xueshanlinghu" target="_blank" rel="noopener noreferrer">雪山凌狐<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>、<a href="https://gitee.com/taotieren" target="_blank" rel="noopener noreferrer">taotieren<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a>、<a href="https://gitee.com/zhishi" target="_blank" rel="noopener noreferrer">吴烜<span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></a></p></div> <footer class="page-edit"><div class="edit-link"><a href="https://gitee.com/gitee-community/opensource-guide/edit/master/第三部分：尝试参与开源/第 6 小节：提交第一个 Issue.md" target="_blank" rel="noopener noreferrer">Edit on Github</a> <span><svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" focusable="false" x="0px" y="0px" viewBox="0 0 100 100" width="15" height="15" class="icon outbound"><path fill="currentColor" d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path> <polygon fill="currentColor" points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg> <span class="sr-only">(opens new window)</span></span></div> <!----></footer> <!----> <div class="comments-wrapper"><div class="valine-wrapper"><div id="valine"></div></div></div> </main> <footer class="footer-wrapper"><div class="media-links-wrapper"><a href="https://gitee.com/gitee-community/opensource-guide" rel="noopener noreferrer" target="_blank" aria-label="Gitee" data-balloon-pos="up" class="media-link"><span class="sr-only">Gitee</span> <svg viewBox="0 0 1024 1024" xmlns="http://www.w3.org/2000/svg" class="icon icon-gitee"><circle cx="512" cy="512" r="512" fill="#C71D23"></circle> <path d="M772.953 454.723H480.17v.006a25.46 25.46 0 00-25.46 25.453l-.025 63.649a25.46 25.46 0 0025.46 25.466l178.242-.007a25.46 25.46 0 0125.459 25.46v12.73c0 42.18-34.198 76.378-76.378 76.378H365.583a25.46 25.46 0 01-25.46-25.46V416.533h-.006c0-42.18 34.192-76.378 76.378-76.378h356.388v-.013a25.46 25.46 0 0025.46-25.446l.057-63.65h.013a25.46 25.46 0 00-25.46-25.471l-356.432.012c-105.453 0-190.946 85.493-190.946 190.946v356.433a25.46 25.46 0 0025.46 25.46H626.56c94.913 0 171.852-76.94 171.852-171.852V480.182a25.46 25.46 0 00-25.46-25.46z" fill="#fff"></path></svg></a></div> <div class="footer">开源指北采用 CC-BY-SA-4.0 进行许可 | 感谢每一位参与的开发者</div> <div class="copyright">Copyright © 2020 开源指北编写小组</div></footer></div><div class="global-ui"><!----><!----><div id="pwa-install"><!----> <div id="install-modal-wrapper" style="display:none;"><div class="background"></div> <div class="install-modal"><div class="header"><button aria-label="Close" class="close-button"><svg width="23" height="22" xmlns="http://www.w3.org/2000/svg" class="icon close-icon"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.12.358a1.224 1.224 0 011.729 0l8.92 8.914L20.686.358a1.224 1.224 0 011.73 1.728L13.497 11l8.92 8.913a1.222 1.222 0 11-1.73 1.729l-8.919-8.913-8.92 8.913a1.224 1.224 0 01-1.729-1.729L10.04 11l-8.92-8.914a1.222 1.222 0 010-1.728z" fill="currentColor"></path></svg></button> <div class="logo"><!----> <div class="title"><h1></h1> <p class="desc">This app can be installed on your PC or mobile device.  This will allow this web app to look and behave like any other installed app.  You will find it in your app lists and be able to pin it to your home screen, start menus or task bars.  This installed web app will also be able to safely interact with other apps and your operating system. </p></div></div></div> <div class="content"><div class="highlight"><!----> <!----></div> <div class="description"><h3>Description</h3> <p></p></div></div> <div class="button-wrapper"><button class="install-button">
        Install <span></span></button> <button class="cancel-button">
        Cancel
      </button></div></div></div></div><div tabindex="-1" role="dialog" aria-hidden="true" class="pswp"><div class="pswp__bg"></div> <div class="pswp__scroll-wrap"><div class="pswp__container"><div class="pswp__item"></div> <div class="pswp__item"></div> <div class="pswp__item"></div></div> <div class="pswp__ui pswp__ui--hidden"><div class="pswp__top-bar"><div class="pswp__counter"></div> <button title="Close (Esc)" class="pswp__button pswp__button--close"></button> <button title="Share" class="pswp__button pswp__button--share"></button> <button title="Toggle fullscreen" class="pswp__button pswp__button--fs"></button> <button title="Zoom in/out" class="pswp__button pswp__button--zoom"></button> <div class="pswp__preloader"><div class="pswp__preloader__icn"><div class="pswp__preloader__cut"><div class="pswp__preloader__donut"></div></div></div></div></div> <div class="pswp__share-modal pswp__share-modal--hidden pswp__single-tap"><div class="pswp__share-tooltip"></div></div> <button title="Previous (arrow left)" class="pswp__button pswp__button--arrow--left"></button> <button title="Next (arrow right)" class="pswp__button pswp__button--arrow--right"></button> <div class="pswp__caption"><div class="pswp__caption__center"></div></div></div></div></div></div></div>
    <script src="/presstest/assets/js/app.2f1bfa80.js" defer></script><script src="/presstest/assets/js/layout-Layout.87e745e0.js" defer></script><script src="/presstest/assets/js/vendors~layout-Blog~layout-Layout~layout-NotFound.5885b1db.js" defer></script><script src="/presstest/assets/js/vendors~layout-Blog~layout-Layout~layout-NotFound~layout-Slide.19644d68.js" defer></script><script src="/presstest/assets/js/vendors~layout-Blog~layout-Layout.5e573c4d.js" defer></script><script src="/presstest/assets/js/page-第6小节：提交第一个Issue.25921032.js" defer></script>
  </body>
</html>
